Add SIP Connection

This request adds a SIP Connection for the customer. Once you have setup the primary SIP Connection, you can add additional branch sites and then provision SBC prefixes for the users at this site location.

URL

Copy 
{{baseUrl}}/api/v2/customer/{customerGuid}/sitelocation/

HTTP Method

POST

Request Parameter

Parameter

Type

Description

umpCustomerGuid

string($uuid)

umpCustomerGuid' value created in the Live Platformcustomer tenant SQL database directory:

■ Operator Connect: A new OC Essentials service is created when a license is applied to the lead using Create Customer from Lead Overview). If this field is null, a license has not yet been applied to the lead.
■ Direct Routing: A new Hosted Essentials service is created by Create Essentials Customer.

Extract this value using Get Services Brief Details (V3) or Get Customers Brief Details (V2) searching for the matching Short Name of the service.

Request Body

Parameter

Type

Description

siteLocationName

string

Desired name of the site location.

ovocCustomerType

string

The supported Live Platform SIP Connection type:

■ IPGROUP_TYPE

sbcId

integer

The SBC Id in the Live Platform database (see Get SBC Devices).

sbcOnboardingScript

integer

The SBC Onboarding script value in the Live Cloud database (see Get Script Templates).

sbcCleanupScript

integer

The SBC Cleanup script value in the Live Cloud database (see Get Script Templates).

scriptParameters

list array

List array including the following parameters:

■ Cac Profile
■ ProxySet
■ OnlinePstnGateway
■ ProxySet
■ CarrierUserName
■ CarrierUserPassword
■ CarrierMailLine
■ CarrierHostName
■ Cac Profile
■ [CustomerVariableName]:

OnlinePstnGateway

string

The name of the OnlinePSTN Gateway of the SBC device that is attached to the Calling Profile (see Get Online PSTN Gateway.

ProxySet

string

The name of the SBC Proxy Set.

CarrierUserName

string

Defines the digest MD5 Authentication username. The valid value is a string of up to 60 characters. By default, no value is defined.

CarrierUserPassword

string

Defines the digest MD5 Authentication password. The valid value is a string of up to 50 characters. Note: The password cannot be configured with wide characters.

CarrierMailLine

string

Defines the AOR username. This appears in REGISTER From/To headers as ContactUser@HostName.

CarrierHostName

string

Defines the Address of Record (AOR) host name. The host name appears in SIP REGISTER From/To headers as ContactUser@HostName.

Cac Profile

string

Defines the desired number of Call Admission Control (CAC) call sessions. For example, "10 sessions". This value also represents the name of the CAC profile. See Get SBC Devices for retrieving CAC profiles.

[CustomerVariableName]: Value String

string

One of the following values:

■ SBC name (Provider SIP Trunk, BYOC or IP-PBX)
■ Region name
■ Carrier name
■ Number of CAC sessions=CAC profile name. For example, "10 sessions" (see above)

Customer variables must be added to the Live Platform database. See Customer Variables.

[CustomerVariableName]: Value String

string

One of the following values:

■ SBC name (Provider SIP Trunk, BYOC or IP-PBX)
■ Region name
■ Carrier name
■ Number of CAC sessions=CAC profile name. For example, "10 sessions" (see above)

Customer variables must be added to the Live Platform database. See Customer Variables.

[CustomerVariableName]: Value String

string

One of the following values:

■ SBC name (Provider SIP Trunk, BYOC or IP-PBX)
■ Region name
■ Carrier name
■ Number of CAC sessions=CAC profile name. For example, "10 sessions" (see above)

Customer variables must be added to the Live Platform database. See Customer Variables.

Example Body

Copy 
{
"siteLocationName": "DR94Site2",
"OvocCustomerType":"IPGROUP_TYPE",
"sbcOnboardingScript": 7,
"sbcCleanupScript": 700,
"sbcId": 8,
"scriptParameters": {
  "OnlinePstnGateway": "DR94Site2.sandbox2.audiocodes.be",
  "ProxySet": "SIPTrunk",
  "CarrierUserName": "Site2Carrier",
  "CarrierUserPassword": "Site2#%00500",
  "CarierMailLine": "Site2MainLine123",
  "CarrierHostName": "Site2Hostname123",
  "CacProfile": "10 sessions",
  "CustomVar.Variable1": "variable4"
  }
}

Example Response

Copy 
{
    "customerGuid": "b11a3f8a-9220-457a-938f-cae531f79d67",
    "siteGuid": "68d85372-f854-4dca-a466-47c876e30892",
    "executionMessages": [
        {
            "level": "Information",
            "message": "Checking SBC IP Group Programming."
        },
        {
            "level": "Information",
            "message": "SBC not programmed yet."
        },
        {
            "level": "Information",
            "message": "Starting SBC Programming."
        },
        {
            "level": "Information",
            "message": "Sbc is programmed"
        },
        {
            "level": "Information",
            "message": "Site location information saved."
        }
    ]
}

HTTP Responses

■ 200 OK
Parameter Type Description

Customer Id

string($uuid)

Unique Id generated for customer. Search for the customer Id by searching for your customer name using Get Services Brief Details (V3).

siteGuid

string($uuid)

Unique Id generated for the SIP Connection location.

executionMessages

list array

List array including the following parameters:

■ level
■ message

level

string

One of the following values:

■ Information
■ Error

message

string

Information message text includes the following strings:

■ Checking SBC IP Group Programming
■ SBC not programmed yet
■ Starting SBC Programming
■ Sbc is programmed
■ Site location information saved